---
layout: documentation
doc-tab: components
doc-subtab: pagination
variables:
- name: $pagination-color
  value: $grey-darker
- name: $pagination-background
  value: $white
- name: $pagination-border-color
  value: $grey-lighter
- name: $pagination-margin
  value: -0.25rem
- name: $pagination-hover-color
  value: $link-hover
- name: $pagination-hover-border-color
  value: $link-hover-border
- name: $pagination-focus-color
  value: $link-focus
- name: $pagination-focus-border-color
  value: $link-focus-border
- name: $pagination-active-color
  value: $link-active
- name: $pagination-active-border-color
  value: $link-active-border
- name: $pagination-disabled-color
  value: $grey
- name: $pagination-disabled-background-color
  value: $grey-lighter
- name: $pagination-disabled-border-color
  value: $grey-lighter
- name: $pagination-current-color
  value: $link-invert
- name: $pagination-current-background-color
  value: $link
- name: $pagination-current-border-color
  value: $link
- name: $pagination-ellipsis-color
  value: $grey-light
- name: $pagination-shadow-inset
  value: inset 0 1px 2px rgba($black, 0
---

{% capture pagination_example %}
<nav class="pagination">
  <a class="pagination-previous">Previous</a>
  <a class="pagination-next">Next page</a>
  <ul class="pagination-list">
    <li>
      <a class="pagination-link">1</a>
    </li>
    <li>
      <span class="pagination-ellipsis">&hellip;</span>
    </li>
    <li>
      <a class="pagination-link">45</a>
    </li>
    <li>
      <a class="pagination-link is-current">46</a>
    </li>
    <li>
      <a class="pagination-link">47</a>
    </li>
    <li>
      <span class="pagination-ellipsis">&hellip;</span>
    </li>
    <li>
      <a class="pagination-link">86</a>
    </li>
  </ul>
</nav>
{% endcapture %}

{% capture pagination_options_example %}
<nav class="pagination">
  <a class="pagination-previous" title="This is the first page" disabled>Previous</a>
  <a class="pagination-next">Next page</a>
  <ul class="pagination-list">
    <li>
      <a class="pagination-link is-current">1</a>
    </li>
    <li>
      <a class="pagination-link">2</a>
    </li>
    <li>
      <a class="pagination-link">3</a>
    </li>
  </ul>
</nav>
{% endcapture %}

{% capture pagination_centered_example %}
<nav class="pagination is-centered">
  <a class="pagination-previous">Previous</a>
  <a class="pagination-next">Next page</a>
  <ul class="pagination-list">
    <li><a class="pagination-link">1</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">45</a></li>
    <li><a class="pagination-link is-current">46</a></li>
    <li><a class="pagination-link">47</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">86</a></li>
  </ul>
</nav>
{% endcapture %}

{% capture pagination_right_example %}
<nav class="pagination is-right">
  <a class="pagination-previous">Previous</a>
  <a class="pagination-next">Next page</a>
  <ul class="pagination-list">
    <li><a class="pagination-link">1</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">45</a></li>
    <li><a class="pagination-link is-current">46</a></li>
    <li><a class="pagination-link">47</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">86</a></li>
  </ul>
</nav>
{% endcapture %}

{% capture pagination_small_example %}
<nav class="pagination is-small">
  <a class="pagination-previous">Previous</a>
  <a class="pagination-next">Next page</a>
  <ul class="pagination-list">
    <li><a class="pagination-link">1</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">45</a></li>
    <li><a class="pagination-link is-current">46</a></li>
    <li><a class="pagination-link">47</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">86</a></li>
  </ul>
</nav>
{% endcapture %}

{% capture pagination_medium_example %}
<nav class="pagination is-medium">
  <a class="pagination-previous">Previous</a>
  <a class="pagination-next">Next page</a>
  <ul class="pagination-list">
    <li><a class="pagination-link">1</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">45</a></li>
    <li><a class="pagination-link is-current">46</a></li>
    <li><a class="pagination-link">47</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">86</a></li>
  </ul>
</nav>
{% endcapture %}

{% capture pagination_large_example %}
<nav class="pagination is-large">
  <a class="pagination-previous">Previous</a>
  <a class="pagination-next">Next page</a>
  <ul class="pagination-list">
    <li><a class="pagination-link">1</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">45</a></li>
    <li><a class="pagination-link is-current">46</a></li>
    <li><a class="pagination-link">47</a></li>
    <li><span class="pagination-ellipsis">&hellip;</span></li>
    <li><a class="pagination-link">86</a></li>
  </ul>
</nav>
{% endcapture %}

{% include subnav-components.html %}

<section class="section">
  <div class="container">
    <h1 class="title">Pagination</h1>
    <h2 class="subtitle">A responsive, usable, and flexible <strong>pagination</strong></h2>
    {%
      include meta.html
      colors=false
      sizes=true
      variables=true
    %}

    <hr>

    <div class="content">
      <p>
        The pagination component consists of several elements:
      </p>
      <ul>
        <li>
          <code>pagination-previous</code> and <code>pagination-next</code> for incremental navigation
        </li>
        <li>
          <code>pagination-list</code> which displays page items:
          <ul>
            <li>
              <code>pagination-link</code> for the page numbers
            </li>
            <li>
              <code>pagination-ellipsis</code> for range separators
            </li>
          </ul>
        </li>
      </ul>
      <p>
        All elements are optional so you can compose your pagination as you wish.
      </p>
    </div>

    <div class="bd-example">
      {{pagination_example}}
    </div>

    {% highlight html %}{{pagination_example}}{% endhighlight %}

    <div class="content">
      <p>
        You can disable some links if they are not active, or change the amount of page numbers available.
      </p>
    </div>

    <div class="bd-example">
      {{pagination_options_example}}
    </div>

    {% highlight html %}{{pagination_options_example}}{% endhighlight %}

    <div class="content">
      <p>
        By default, the list is located on the left, and the previous/next buttons on the right. But you can change the <strong>order</strong> of these elements by using the <code>is-centered</code> and <code>is-right</code> modifiers.
      </p>
    </div>

    <div class="bd-example">
      {{pagination_centered_example}}
    </div>

    {% highlight html %}{{pagination_centered_example}}{% endhighlight %}

    <div class="bd-example">
      {{pagination_right_example}}
    </div>

    {% highlight html %}{{pagination_right_example}}{% endhighlight %}

    <hr style="margin-bottom: 0;">

    <h2 id="sizes" class="title" style="padding-top: 1.5rem;">
      Sizes
    </h2>

    <p class="content">
      The pagination comes in <strong>3 additional sizes</strong>.<br>
      You only need to append the <strong>modifier</strong> <code>is-small</code>, <code>is-medium</code>, or <code>is-large</code> to the <code>pagination</code> component.
    </p>

    <div class="bd-example">
      {{pagination_small_example}}
    </div>

    <div class="bd-example">
      {{pagination_medium_example}}
    </div>

    <div class="bd-example">
      {{pagination_large_example}}
    </div>

    {% include variables.html %}

  </div>
</section>
